Bug 540834 – Insensitive widgets cannot be grabbed

2008-08-02  Matthias Clasen  <mclasen@redhat.com>

        Bug 540834 – Insensitive widgets cannot be grabbed

        * gtk/tmpl/gtkmain.sgml: Explain that insensitive widgets
        cannot be grabbed. Patch by Björn Lindqvist

svn path=/trunk/; revision=20933

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index bf012a08bc0cb92f10e57e37460b3c472810f250..62a2dca9ca9cc9b79cb9f6dc56b7a6e0004b5b45 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,10 @@
+2008-08-02  Matthias Clasen  <mclasen@redhat.com>
+
+       Bug 540834 – Insensitive widgets cannot be grabbed
+
+       * gtk/tmpl/gtkmain.sgml: Explain that insensitive widgets
+       cannot be grabbed. Patch by Björn Lindqvist
+
 2008-08-02  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtk-sections.txt: Update

diff --git a/docs/reference/gtk/tmpl/gtkmain.sgml b/docs/reference/gtk/tmpl/gtkmain.sgml
index 5907513d44d4cc9a1225eda70fc7691dae3c9c1c..d97196d99be371b8286c0a04d63b9ca5f67e89c9 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkmain.sgml
+++ b/docs/reference/gtk/tmpl/gtkmain.sgml
@@ -381,6 +381,10 @@ Makes @widget the current grabbed widget. This means that interaction with
 other widgets in the same application is blocked and mouse as well as 
 keyboard events are delivered to this widget.
 </para>
+<para>
+If @widget is not sensitive, it is not set as the current grabbed
+widget and this function does nothing.
+</para>  
 
 @widget: The widget that grabs keyboard and pointer events.
 
@@ -398,6 +402,9 @@ Queries the current grab of the default window group.
 Removes the grab from the given widget. You have to pair calls to gtk_grab_add()
 and gtk_grab_remove().
 </para>
+<para>
+If @widget does not have the grab, this function does nothing.
+</para>
 
 @widget: The widget which gives up the grab.